MCP 문서 관리

메뉴

홈
문서 목록
관리자 로그인

문서 정보

최종 수정일:
2025-05-13 00:29
태그:
#써드파티 #MCP #결제 #인보이스 #비즈니스

링크된 문서

역링크

PayPal

PayPal

PayPal MCP 서버는 PayPal의 결제 처리, 인보이싱 및 비즈니스 관리 기능과의 원활한 통합을 제공하는 Model Context Protocol(MCP) 서버입니다. 이 서버를 통해 AI 어시스턴트와 개발자는 자연어 명령을 사용하여 PayPal API와 상호작용할 수 있습니다.

특징

  • AI 통합: 자연어 처리를 통해 PayPal 서비스를 쉽게 사용 가능
  • 다양한 기능: 결제, 인보이스, 분쟁 관리, 배송 추적, 카탈로그 관리 등 다양한 도구 제공
  • 로컬 및 원격 옵션: 로컬에서 실행하거나 클라우드 기반 원격 서버 접근 가능
  • 다중 프레임워크 지원: OpenAI의 Agent SDK, LangChain, Vercel의, AI SDK 등 다양한 AI 프레임워크와 호환
  • 인증 통합: 클라우드 환경에서 인증 통합을 통한 원활한 사용자 경험

사용 사례

  • 인보이스 자동화: AI를 활용한 인보이스 생성 및 관리
  • 결제 처리: 자연어 명령을 통한 주문 생성 및 결제 처리
  • 구독 관리: 구독 계획 설정 및 관리 자동화
  • 데이터 분석: 거래 내역, 인보이스 데이터 등의 분석 및 보고서 생성
  • 분쟁 해결: 고객 분쟁 관리 및 추적

API

도구

PayPal MCP 서버는 다음과 같은 주요 도구를 제공합니다:

인보이스 관리

create_invoice

새 인보이스 생성 - 입력: - 인보이스 세부 정보(수신자, 금액, 항목, 만기일 등)

list_invoices

인보이스 목록 조회 - 입력: - 페이지 크기(선택) - 필터(선택)

get_invoice

특정 인보이스 상세 정보 검색 - 입력: - 인보이스 ID

send_invoice

인보이스 수신자에게 전송 - 입력: - 인보이스 ID

send_invoice_reminder

기존 인보이스 알림 전송 - 입력: - 인보이스 ID - 알림 메시지(선택)

cancel_sent_invoice

전송된 인보이스 취소 - 입력: - 인보이스 ID

generate_invoice_qr_code

인보이스용 QR 코드 생성 - 입력: - 인보이스 ID

결제 처리

create_order

주문 생성 - 입력: - 주문 세부 정보(금액, 상품 등)

get_order

주문 세부 정보 조회 - 입력: - 주문 ID

pay_order

승인된 주문 결제 처리 - 입력: - 주문 ID

분쟁 관리

list_disputes

모든 오픈 분쟁 요약 조회 - 입력: - 필터링 옵션(선택)

get_dispute

특정 분쟁의 상세 정보 조회 - 입력: - 분쟁 ID

accept_dispute_claim

분쟁 클레임 수락 - 입력: - 분쟁 ID

배송 추적

create_shipment_tracking

배송 추적 기록 생성 - 입력: - 주문 ID - 배송 추적 정보

get_shipment_tracking

배송 추적 정보 조회 - 입력: - 추적 ID

카탈로그 관리

create_product

PayPal 카탈로그에 새 제품 생성 - 입력: - 제품 세부 정보(이름, 설명, 카테고리 등)

list_products

제품 목록 조회 - 입력: - 페이지 크기(선택) - 필터(선택)

show_product_details

특정 제품 세부 정보 조회 - 입력: - 제품 ID

구독 관리

create_subscription_plan

새 구독 계획 생성 - 입력: - 계획 세부 정보(이름, 가격, 주기 등)

list_subscription_plans

구독 계획 목록 조회 - 입력: - 필터링 옵션(선택)

show_subscription_plan_details

특정 구독 계획 세부 정보 조회 - 입력: - 계획 ID

create_subscription

새 구독 생성 - 입력: - 구독 세부 정보(계획 ID, 구독자 정보 등)

show_subscription_details

특정 구독 세부 정보 조회 - 입력: - 구독 ID

cancel_subscription

활성 구독 취소 - 입력: - 구독 ID

보고 및 인사이트

list_transactions

거래 목록 조회 - 입력: - 필터링 옵션(시간 범위, 거래 유형 등)

사용 방법

필수 조건

PayPal MCP 서버를 사용하기 전에 다음 사항이 필요합니다: - Node.js v18 이상 - PayPal 개발자 계정 - 클라이언트 ID 및 클라이언트 시크릿 또는 액세스 토큰

설치 및 실행 (로컬)

로컬에서 PayPal MCP 서버를 실행하는 가장 쉬운 방법은 npx를 사용하는 것입니다:

npx -y @paypal/mcp --tools=all PAYPAL_ACCESS_TOKEN="YOUR_ACCESS_TOKEN" PAYPAL_ENVIRONMENT="SANDBOX"

또는 환경 변수로 설정할 수도 있습니다:

export PAYPAL_ACCESS_TOKEN="YOUR_ACCESS_TOKEN"
export PAYPAL_ENVIRONMENT="SANDBOX"
npx -y @paypal/mcp --tools=all

원격 사용 (클라우드 기반)

PayPal은 클라우드 환경에서 실행되는 원격 MCP 서버도 제공합니다. 이를 통해 로컬 설치 없이도 PayPal MCP 서버를 사용할 수 있습니다:

  • 접근 URL: https://mcp.paypal.com/sse
  • OAuth2.1 인증 지원

Claude Desktop 연동

Claude Desktop에서 PayPal MCP 서버를 사용하려면:

  1. Claude Desktop 설정 파일을 열기:
  2. macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  3. Windows: %APPDATA%/Claude/claude_desktop_config.json

  4. 다음 구성 추가: 

    {
  "mcpServers": {
    "paypal": {
      "command": "npx",
      "args": [
        "-y",
        "@paypal/mcp",
        "--tools=all"
      ],
      "env": {
        "PAYPAL_ACCESS_TOKEN": "YOUR_PAYPAL_ACCESS_TOKEN",
        "PAYPAL_ENVIRONMENT": "SANDBOX"
      }
    }
  }
}

  5. Claude Desktop 재시작

Cursor 연동

Cursor에서 PayPal MCP 서버를 사용하는 방법:

  1. Cursor 설정 > 기능 > MCP로 이동
  2. "+ Add New MCP Server" 버튼 클릭
  3. 양식 작성:
  4. 유형: stdio 선택
  5. 이름: paypal
  6. 명령어: npx -y @paypal/mcp --tools=all
  7. 환경 변수:
    • PAYPAL_ACCESS_TOKEN: 액세스 토큰 값
    • PAYPAL_ENVIRONMENT: SANDBOX 또는 PRODUCTION

인증 설정

PayPal 액세스 토큰 생성 방법

  1. PayPal 개발자 계정 준비:
  2. PayPal 개발자 대시보드(https://developer.paypal.com/dashboard/)에 접속

  3. PayPal 계정으로 로그인

  4. 클라이언트 ID 및 시크릿 가져오기:

  5. 개발자 대시보드에서 'Apps & Credentials' 클릭
  6. 환경(Sandbox/Live)에 따라 탭 선택
  7. 새 앱 생성: 'Create App' 클릭 및 앱 이름 지정
  8. 기존 앱: 앱 이름 클릭하여 세부 정보 확인

  9. Client ID와 Client Secret 저장

  10. 액세스 토큰 생성:

  11. cURL 사용: 

    curl -v https://api-m.sandbox.paypal.com/v1/oauth2/token \
-H "Accept: application/json" \
-H "Accept-Language: en_US" \
-u "CLIENT_ID:CLIENT_SECRET" \
-d "grant_type=client_credentials"

  12. Postman 사용:

    • https://api-m.sandbox.paypal.com/v1/oauth2/token 엔드포인트로 POST 요청
    • 'Basic Auth'에서 클라이언트 ID와 시크릿 입력
    • Body에 grant_type=client_credentials 추가

  13. 응답에서 access_token 값 추출: 

    {
  "scope": "...",
  "access_token": "Your_Access_Token",
  "token_type": "Bearer",
  "app_id": "APP-80W284485P519543T",
  "expires_in": 32400,
  "nonce": "..."
}

참고: Sandbox 토큰은 3-8시간, 프로덕션 토큰은 8시간 동안 유효합니다.

사용 예시

Claude Desktop 사용 예시

예시 1: 인보이스 생성 

사용자: 도색 서비스에 대해 $450, 세금 8%, 할인 5%가 적용되고 10일 후 만료되는 PayPal 인보이스 링크를 생성해주세요.

Claude는 MCP를 사용하여 인보이스를 생성합니다: 

도색 서비스에 대한 인보이스를 생성하겠습니다.

인보이스가 성공적으로 생성되었습니다.
인보이스 ID: INV2-XXXX-XXXX-XXXX-XXXX
금액: $450.00
세금: 8% ($36.00)
할인: 5% ($22.50)
총 금액: $463.50
만료일: 2025년 5월 23일

인보이스 링크가 생성되었습니다: https://www.paypal.com/invoice/p/#XXXXX

예시 2: 거래 내역 조회 

사용자: 지난 30일 동안의 PayPal 거래 내역을 조회해주세요.

Claude는 MCP를 사용하여 거래 내역을 조회합니다: 

지난 30일 동안의 PayPal 거래 내역을 조회했습니다:

총 거래 수: 12
총 금액: $2,354.80
완료된 거래: 10
대기 중인 거래: 2

최근 5개 거래:
1. 2025-05-10: $450.00 - 도색 서비스 (상태: 완료)
2. 2025-05-08: $129.99 - 월간 구독 (상태: 완료)
3. 2025-05-03: $599.00 - 전자제품 구매 (상태: 완료)
4. 2025-04-25: $75.50 - 컨설팅 서비스 (상태: 대기 중)
5. 2025-04-20: $199.99 - 소프트웨어 라이센스 (상태: 완료)

더 자세한 정보가 필요하신가요?

문제 해결

일반적인 문제

연결 오류

"Failed to connect to PayPal API"와 같은 오류가 표시되는 경우: - 액세스 토큰이 유효한지 확인 - 인터넷 연결 확인 - 환경 설정(SANDBOX/PRODUCTION)이 올바른지 확인

인증 문제

인증 오류가 표시되는 경우: - 액세스 토큰 만료 여부 확인 (새로운 토큰 생성 필요할 수 있음) - 클라이언트 ID와 시크릿이 올바른지 확인 - 필요한 권한이 부여되었는지 확인

도구를 찾을 수 없음

MCP 도구가 Claude Desktop 또는 Cursor에 표시되지 않는 경우: - 애플리케이션 재시작 - 구성 파일에서 오타 확인 - 명령어와 인수가 올바르게 설정되었는지 확인

제한 사항 및 참고 사항

  • PayPal의 MCP 서버는 AI 생성 콘텐츠를 제공하며, 사용자는 정보를 독립적으로 확인할 책임이 있습니다.
  • PayPal은 출력 정확성에 대해 보장하지 않으며, 이로 인한 결정, 조치 또는 결과에 대한 책임을 지지 않습니다.
  • Sandbox 환경에서 충분히 테스트한 후 프로덕션 환경으로 전환하는 것이 권장됩니다.
  • 토큰 관리를 위한 자동 갱신 로직 구현을 고려하세요.

연결된 구성 요소